home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir24 / tn-x1jr2.zip / TN-X1J2.ZIP / USERGUID.TXT < prev   
Text File  |  1994-03-17  |  19KB  |  425 lines

  1.                    USER GUIDE FOR TheNet X-1J
  2.         
  3. This  brief  note  is  intended for users  of  TheNet  X-1J,  and 
  4. explains the basic commands. Configuration and sysop features are 
  5. not covered fully.
  6.  
  7. TheNet X-1J is an extension of TheNet 1, and provides a number of 
  8. new features.
  9.  
  10. The switch provides the following user commands :
  11.  
  12.                   Connect
  13.                   Info
  14.                   Nodes
  15.                   Routes
  16.                   Users
  17.                   Talk
  18.                   CQ
  19.                   BBS
  20.                   Host
  21.                   MHeard
  22.                   Bye
  23.                   DXcluster
  24.                   IProute
  25.                   ARP
  26.                   QUIT
  27.                   ADC
  28.         
  29. Not  all  commands  may be available on  every  node  as  certain 
  30. commands might have been disabled. If a command has been enabled, 
  31. it  will  be displayed when you type an invalid command  such  as 
  32. '?'. In  addition, there are some commands that are available but 
  33. are not usually displayed. The main ones of interest are :
  34.  
  35.                   Links
  36.                   Mode
  37.                   Parms
  38.                   Stats
  39.                   IPAddress
  40.                   DXCAlias
  41.                   BBSAlias
  42.                   HostAlias
  43.                   MTU
  44.         
  45. The Sysop may have customised the command list according to local 
  46. needs.
  47.  
  48. In  general, commands take parameters, for example to connect  to 
  49. GB7MXM,  the command to be entered is CONNECT GB7MXM followed  by 
  50. return. Usually, commands are not case sensitive, ( although node 
  51. aliases may be ) and commands may be abbreviated.
  52.  
  53. Connect
  54.         
  55.      If  the connect command is given on its own,  then  assuming 
  56.      that  the  sysop  has  set it up  correctly,  you  will  get 
  57.      connected to the local BBS.
  58.      
  59.      If you give another callsign, either of a local station or a 
  60.      node,  the node will attempt to connect you to that  station 
  61.      either by a level 4 connection or by downlinking. If you are 
  62.      downlinking, you may also specify digipeaters.
  63.      
  64.      In  either  case, you get either a connected  message  or  a 
  65.      message telling you of the failure to connect. If you  enter 
  66.      any other command at this stage, the connection attempt will 
  67.      be aborted.
  68.      
  69.      If  you attempt to downlink with digipeating, or attempt  to 
  70.      downlink to an invalid callsign such as a node alias with an 
  71.      SSID,  you  may get an error message depending  on  how  the 
  72.      Sysop has configured the node.
  73.      
  74.      Finally, if you connect to the node, then connect to another 
  75.      station, and that station disconnects you ( e.g. connect  to 
  76.      a  BBS  and  use the 'Bye' command of the BBS  ),  you  will 
  77.      either   get  reconnected  to  the  node   or   disconnected 
  78.      completely depending on the configuration of the node.
  79.      
  80.      If you enter a node alias and get an 'invalid call' message, 
  81.      it  can either be because the node is not recognised  or  it 
  82.      can  be  because  the  Sysop  has  made  node  aliases  case 
  83.      sensitive.
  84.      
  85. Info 
  86.  
  87.      This   command  gives  information  about  the  node  as   a 
  88.      combination  of a message stored in the EPROM and a  message 
  89.      entered by the Sysop.
  90.         
  91. Nodes
  92.         
  93.      This command gives information about the distant nodes  that 
  94.      this node thinks it can get to. With no parameter, it  shows 
  95.      the alias and callsign of all the nodes except those staring 
  96.      with a '#' character. If a parameter of '*' is given,  those 
  97.      'hidden' nodes will also be shown.
  98.      
  99.      If a callsign or alias is given that the node does not know, 
  100.      it  gives  an error message. If the callsign or alias  of  a 
  101.      known node is given, the node gives details of the routes it 
  102.      knows about that lead to that destination. The display shows 
  103.      one  option  per line, each of which consists  of  the  path 
  104.      quality,  obsolescence  count  and  port  followed  by   the 
  105.      callsign of the neighbour. If any route is in use, a chevron 
  106.      is shown against the appropriate entry.
  107.      
  108.      If  so  configured by the Sysop, 'Slime trails'  i.e.  nodes 
  109.      without  aliases that have not been the subject of  a  valid 
  110.      node broadcast, may be omitted from the nodes list.
  111.         
  112. Routes
  113.         
  114.      This command gives information about the neighbouring  nodes 
  115.      that can be heard. For each neighbour, the display shows the 
  116.      port  number, the callsign, the path quality and the  number 
  117.      of  nodes accessible through this neighbour. If a route  has 
  118.      been  'locked' by the sysop, then a '!'  character is  shown 
  119.      after  an entry. The sysop may have configured the  node  to 
  120.      display  nodes  as  callsign or  as  alias:callsign.  If  so 
  121.      configured,  then if a node is shown as a callsign alone  it 
  122.      means  that  is  it  not currently  reachable  as  its  node 
  123.      broadcasts are not being received.
  124.         
  125. Users
  126.         
  127.      This  shows  who is using the node. It does not  show  other 
  128.      nodes  that are using the node as a level 3 relay, nor  does 
  129.      it  show  those  users who have connected to  the  node  but 
  130.      otherwise have done nothing.
  131.      
  132.      The display shows the through connections, followed by those 
  133.      users  who are connected to the switch and 'idle'.  It  also 
  134.      shows  those  users who are connected  to  the  conferencing 
  135.      facility.  The  latter  stations are shown  connected  to  a 
  136.      destination   called   'Talk',  whilst  in   the   case   of 
  137.      connections,  the two endpoints are shown. For  connections, 
  138.      two symbols are used, '<-->' and '<..>'. The former is  used 
  139.      for  established connections whilst the latter is  used  for 
  140.      connections being established.
  141.      
  142. Talk
  143.         
  144.      The  Talk  command  allows  a  group  of  users  to  hold  a 
  145.      conference call. It also allows a user to send a message  to 
  146.      another user of the node provided that user is connected  to 
  147.      the switch but is not patched through to another station and 
  148.      is not currently trying to connect to another station.
  149.      
  150.      A  user enters the conference by giving the command  'talk'. 
  151.      He/she  gets a message informing them of this and  reminding 
  152.      them  that  the command to escape from the talk  command  is 
  153.      '/exit'.  Any other users currently in the conference get  a 
  154.      message  from the node telling them of the callsign  of  the 
  155.      user who has joined them. At this point, every line sent  by 
  156.      a user in the conference is copied to all other users in the 
  157.      conference, preceded by their callsign.
  158.      
  159.      To  exit from the conference, the command '/exit'  is  used. 
  160.      This  causes a response message to be sent to the user,  and 
  161.      at  the same time all of those left in the conference get  a 
  162.      message  from the node telling them of the station  who  has 
  163.      left  the conference. If you force a disconnect,  the  other 
  164.      stations are not told of your departure.
  165.      
  166.      A string of text may be entered on the same line as the talk 
  167.      command  when the command is given. If this is done,  before 
  168.      the user is connected to the conference, that string of text 
  169.      is sent to all the other users of the node who appear in the 
  170.      'user'  list  but are not connected to  anything  else.  For 
  171.      example if GxABC were to type :
  172.      
  173.           TALK GyXYZ, Hello fred can I have a chat - type TALK
  174.  
  175.      then  other users of the node ( including  presumably  Fred, 
  176.      would get the message :
  177.         
  178.           GxABC>> GyXYZ. Hello fred can I have a chat - type TALK
  179.  
  180.      on their screens. The only exception to this is that  sysops 
  181.      are not sent the message.
  182.      
  183.      Note that the TALK command will pass 8 bit data if set to by 
  184.      the Sysop.
  185.         
  186. CQ
  187.         
  188.      This command is used to broadcast a CQ message. In addition, 
  189.      the  fact that you are calling CQ is indicated in  the  USER 
  190.      list.  The callsign will be your own with a different  SSID, 
  191.      and  anyone  else can connect to you by  connecting  to  the 
  192.      callsign with the appropriate SSID.
  193.      
  194.      The  CQ  remains  'primed' for a while,  and  if  any  other 
  195.      command is given to the node the CQ will be cancelled.
  196.         
  197. BBS
  198.         
  199.      When you issue the BBS command, assuming that the sysop  has 
  200.      configured it, you will be connected to the local BBS.
  201.      
  202.      If  you enter the command 'BBS ?', then the current  setting 
  203.      of the BBS will be displayed.
  204.         
  205. Host
  206.         
  207.      The HOST command operates just like the BBS command. It  may 
  208.      have  been  disabled by the sysop, it may have been  set  to 
  209.      connect to the same station as the BBS, or it may have  been 
  210.      set to connect to another host system.
  211.      
  212.      If you enter the command 'HOST ?', then the current  setting 
  213.      of the HOST will be displayed. 
  214.  
  215. MHeard
  216.         
  217.      If  enabled,  the  heard list shows the  last  few  stations 
  218.      heard. The number of entries is limited and set by the sysop 
  219.      so any stations not heard for a while may get pushed out  of 
  220.      the  list  by others heard. Assuming that a station  is  not 
  221.      pushed  out in this manner, the display shows the number  of 
  222.      packets  heard  from that station since it appeared  in  the 
  223.      list  and  the  time since it was last heard.  The  time  is 
  224.      hours, minutes and seconds. The list also shows the port  on 
  225.      which  the station was heard ( port 0 is the radio  port  ), 
  226.      and if it hears IP frames or Net/Rom frames, it adds a  note 
  227.      to show that the station is a node and/or a TCP/IP station.
  228.      
  229.      If  the list is long enough so that a station is  not  heard 
  230.      for 12 hours, it will get deleted anyway.
  231.      
  232.      The  list  may also show a column headed 'Dev.'.  This  will 
  233.      only  be  present where the sysop has added to  the  node  a 
  234.      small hardware board that measures the received signal audio 
  235.      level.  Specifically,  it gives an indication  of  the  peak 
  236.      audio  level. By means of a software  configuration  control 
  237.      and   prior  calibration,  this  gets  converted   into   an 
  238.      indication  of the transmitting station's signal  deviation. 
  239.      It  does this by sampling the audio level after every  valid 
  240.      packet.
  241.      
  242.      Care  must  be taken over its interpretation.  It  does  not 
  243.      measure  independently the two tone levels - it  is  assumed 
  244.      that whatever local standards that relate to pre-emphasis  ( 
  245.      i.e. use it or not ) have been implemented.
  246.      
  247.      Often,  packet  stations  are set up, and  the  audio  level 
  248.      tweaked until it appears to work reasonably error free.  The 
  249.      idea  of  this add-on is that, having done  that,  you  then 
  250.      connect  to  the node and display the heard list to  see  an 
  251.      indication  of  your actual deviation. It may then  be  fine 
  252.      tuned  to set it correctly. Local advice must be taken  over 
  253.      the  correct  setting as it depends on the  channel  spacing 
  254.      being used ( e.g. 12.5, 25 or other KHz ).
  255.      
  256.      The  meter  will  give the wrong  answer  on  the  following 
  257.      conditions :
  258.      
  259.        
  260.             A badly distorted audio signal
  261.             Badly off frequency
  262.             Incorrect adherence to local pre-emphasis standards
  263.             A noisy signal
  264.         
  265.      If  you connect, then correct your deviation to the  correct 
  266.      display then find performance has deteriorated, it indicates 
  267.      one of the above problems. It is not that the meter  doesn't 
  268.      work, it is an indication of a fault elsewhere.
  269.      
  270.      It  is in your own interest for those around you to use  the 
  271.      correct  deviation.  The  list also allows you  to  see  the 
  272.      deviation of others - so apply peer pressure if someone over 
  273.      or  under deviates. Remember it is NOT a case of the  higher 
  274.      or the lower the better - it is having the setting RIGHT.
  275.      
  276.      The system may also be used to migrate users towards a lower 
  277.      deviation in advance of moving to narrower channel spacing.
  278.      
  279.      The  heard list may also show received signal  strength.  It 
  280.      shows  how  strong  each station is  at  the  receiver.  The 
  281.      display will either be in dBm format or in the familiar  'S1 
  282.      to  S9' format ( or 'S9+' for big signals ).  To  understand 
  283.      this  properly  will need some guidance from the  sysop.  By 
  284.      looking at the METER parameters you can find the noise floor 
  285.      in  dBm, and if the display is in dBm can subtract one  from 
  286.      the other to find out how much stronger your signal is  than 
  287.      it  needs to be. How accurate this is depends on  the  radio 
  288.      and  its calibration. It could be as close as +- 1 dB or  it 
  289.      could be wildly wrong.
  290.      
  291. Links
  292.         
  293.      The LINKS command shows the level 2 connections to the node. 
  294.      This  is  usually  of academic interest, but  I  use  it  in 
  295.      testing. The display shows the links, one per line, with the 
  296.      two  callsigns,  the  link state, the port  number  and  the 
  297.      current number of retries.
  298.         
  299. Mode
  300.         
  301.      The MODE command is a bit like the PARMS command. It shows a 
  302.      number  of  additional parameters. These are as  follows  as 
  303.      shown by example :
  304.         
  305.        MODE
  306.        THENET:G8KBB-5> 0 1800 6 3 2 20 0 600 2 900 1 31 0 1 1 0 0
  307.  
  308.      with the following meanings :
  309.         
  310.        0    Host mode protocol ( 0 = standard, 1 = DCD mode )
  311.        1800 CWID period. Delay in seconds between CWID
  312.        6    CWID speed 10's of msec per dot. 6 equals 20 wpm
  313.        3    Enable / disable nodes broadcasts mask.
  314.        2    RS232 protocol, 0 = crosslink, 1,2 or 3 are KISS
  315.        20   TxDelay in 10's of milliseconds ( Centiseconds ?? )
  316.        0    Full duplex control. 0 equals simplex
  317.        600  RS232 port nodes broadcast interval in seconds
  318.        2    Nodes broadcast algorithm port mask
  319.        900  Beacon period in seconds
  320.        1    'connect' redirector. 0 is to HOST, 1 is to BBS, 2 is 
  321.             to DXCluster
  322.        31   Each bit controls one of the 'user' help messages,  8 
  323.             bit TALK, case sensitivity & TexNet i/f
  324.        0    This byte controls the broadcasting of 'hash' nodes
  325.        1    This   byte  enables  /  disables  the  extra   alias 
  326.             operation
  327.        1    If set to '1', a remote disconnect on a circuit  will 
  328.             cause a node reconnection
  329.        0    The  bits of this controls the operation of the  node 
  330.             with regard to 'slime trails'
  331.        0    The  bits  of this control whether digi  uplinks  and 
  332.             downlinks are permitted
  333.         
  334.      If you want additional details, ask the sysop for a copy  of 
  335.      the overview guide.
  336.      
  337. Parms
  338.         
  339.      This shows the node parameters as per TheNet 1.01 ( I am not 
  340.      going to list them again here. Sorry ).
  341.         
  342. Bye and Quit
  343.         
  344.      These  commands disconnects you from the node,  closing  the 
  345.      link.  It  says goodbye before disconnecting you if  it  has 
  346.      been so configured by the sysop. Quit does just the same  as 
  347.      Bye does.
  348.         
  349. DXcluster
  350.         
  351.      If  there is a local DXcluster, this command may  have  been 
  352.      configured  by the sysop to connect you to it. It  therefore 
  353.      operates in a manner very similar to the BBS command.
  354.         
  355. Stats
  356.         
  357.      The  stats  command  gives  lots  of  data  about  the  node 
  358.      operation.   A  full  description  of  the  information   is 
  359.      contained in the overview document.
  360.         
  361. IProute
  362.         
  363.      This command is used by the sysop to configure the IP  route 
  364.      table. It may also be used to display the router table.
  365.         
  366. Arp
  367.         
  368.      This  command is similar to the IProute command,  but  shows 
  369.      the Arp table. The Arp table provides a translation from  IP 
  370.      address to callsign.
  371.         
  372. IPaddress
  373.         
  374.      This  command is used to set or display the current node  IP 
  375.      address.
  376.         
  377. BBSAlias
  378. HostAlias
  379. DXCAlias
  380.         
  381.      These  commands are used to set additional aliases  for  the 
  382.      node.  It can be configured by the sysop to  accept  connect 
  383.      requests  ( uplinks ) to the node callsign, the node  alias, 
  384.      or  the  3 aliases shown by these commands.  When  the  node 
  385.      accepts  a  connection  to one of  these  aliases,  it  will 
  386.      immediately  invoke the BBS, DXC or HOST commands  for  you. 
  387.      The  way this would normally be used is as follows.  Suppose 
  388.      your  local  ( for example ) BBS was not accessible  on  the 
  389.      frequency  that the node operates on. The BBS alias  can  be 
  390.      configured to provide easy access across other nodes to  the 
  391.      BBS. Hence in the case of the Ipswich nodes, GB7MXM does not 
  392.      have a port on 144.650, but the node IPS2 on 144.650 can get 
  393.      to it by means of another node and a 9600 baud link. If IPS2 
  394.      is  set to accept the extra aliases, and if BBSAlias is  set 
  395.      to MXMBBS, then anyone who tries to uplink to MXMBBS in  the 
  396.      Ipswich area would be automatically connected to GB7MXM.  It 
  397.      goes  without  saying that if GB7MXM had a port  on  144.650 
  398.      itself, then chaos would ensue. 
  399.      
  400. MTU
  401.  
  402.      This command allows configuration of the MTUs for IP  users. 
  403.      The parameters have the following meanings :
  404.      
  405.      Parameter Default        Controls
  406.      ============================================================
  407.           1      256    The   MTU  for  the  radio  port,   AX.25 
  408.                         encapsulation
  409.           2      256    The   MTU  for  the  RS232  port,   AX.25 
  410.                         encapsulation
  411.           3      236    The MTU for the Net/Rom encapsulation
  412.           4      257    The  maximum  number of data bytes  in  a 
  413.                         received L2 frame
  414.           5      328    The maximum number of bytes in a received 
  415.                         L2 frame
  416.      
  417.      For  more details on the IP router, consult  the  'overview' 
  418.      document.
  419.      
  420. ADC
  421.         
  422.      This command is used to read up to 2 channels of DC voltage. 
  423.      Whether  they  are enabled, and what they read  is  a  local 
  424.      decision by the Sysop.
  425.